| Pakket | flash.globalization |
| Klasse | public final class DateTimeFormatter |
| Overerving | DateTimeFormatter  Object |
| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10.1, AIR 2 |
Er zijn twee manieren om een datum-/tijdnotatie te selecteren: met een vooraf gedefinieerd patroon of met een aangepast patroon. Bij de meeste toepassingen moeten de vooraf gedefinieerde stijlen worden gebruikt die door de DateTimeStyle-constanten (LONG, MEDIUM, NONE en SHORT) worden aangegeven. Deze constanten geven de standaardpatronen van de gevraagde landinstelling aan of de standaardpatronen op basis van de besturingssysteeminstellingen van de gebruiker.
Met de volgende code wordt bijvoorbeeld een datumtekenreeks met de korte standaarddatumnotatie gemaakt:
var df:DateTimeFormatter = new DateTimeFormatter(LocaleID.DEFAULT, DateTimeStyle.SHORT, DateTimeStyle.NONE);
var currentDate:Date = new Date();
var shortDate:String = df.format(currentDate);
Als een instantie van deze klasse wordt gemaakt en de gevraagde landinstelling wordt door het besturingssysteem ondersteund, dan worden de eigenschappen van de instantie ingesteld op basis van de conventies en standaardinstellingen van de gevraagde landinstelling en de parameters dateStyle en timeStyle van de constructor. Als de aangevraagde landinstelling niet beschikbaar is, worden de eigenschappen ingesteld volgens een fallback- of standaardlandinstelling van het systeem, die kan worden opgehaald met de eigenschap actualLocaleIDName.
Deze klasse bevat aanvullende methoden voor het ophalen van gelokaliseerde tekenreeksen voor namen van maanden en dagen en voor het ophalen van de eerste dag van de week die kan worden gebruikt in een kalenderkiezer of een soortgelijke toepassing.
Door de toepassing van gebruikersinstellingen, van besturingssysteemspecifieke opmaakpatronen en van een fallback-landinstelling die wordt toegepast wanneer een gevraagde landinstelling niet wordt ondersteund, komt het voor dat gebruikers soms een andere opmaak zien, ook al wordt dezelfde landinstellings-id gebruikt.
Verwante API-elementen
Overerfde openbare eigenschappen verbergen
Overerfde openbare eigenschappen weergeven| Eigenschap | Gedefinieerd door | ||
|---|---|---|---|
| actualLocaleIDName : String [alleen-lezen]
De naam van de werkelijke landinstellings-id die door dit DateTimeFormatter-object wordt gebruikt. | DateTimeFormatter | ||
 | constructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie. | Object | |
| lastOperationStatus : String [alleen-lezen]
De status van de voorgaande bewerking die door dit object DateTimeFormatter is uitgevoerd. | DateTimeFormatter | ||
| requestedLocaleIDName : String [alleen-lezen]
De naam van de aangevraagde landinstellings-id die is doorgegeven aan de constructor van dit DateTimeFormatter-object. | DateTimeFormatter | ||
| Methode | Gedefinieerd door | ||
|---|---|---|---|
DateTimeFormatter(requestedLocaleIDName:String, dateStyle:String = "long", timeStyle:String = "long")
Maakt een nieuw DateTimeFormatter-object waarmee de datum en tijd worden opgemaakt volgens de conventies van de opgegeven landinstelling en opmaakstijl voor de datum en tijd. | DateTimeFormatter | ||
Bepaalt de opmaak van een weergavetekenreeks voor een Date-object waarvan wordt aangenomen dat het in de lokale tijd van de gebruiker staat, dat wil zeggen: met de lokale tijdcomponenten van het Date-object (date, day, fullYear, hours, minutes, month en seconds). | DateTimeFormatter | ||
Bepaalt de opmaak van een weergavetekenreeks voor een Date-object waarvan wordt aangenomen dat het in UTC-tijd staat, dat wil zeggen: met de UTC-tijdcomponenten van het Date-object (dateUTC, dayUTC, fullYearUTC, hoursUTC, minutesUTC, monthUTC en secondsUTC), volgens het dateStyle-, timeStyle- of datumtijdpatroon. | DateTimeFormatter | ||
[statisch]
Biedt een overzicht van alle namen van landinstellings-id's die door deze klasse worden ondersteund. | DateTimeFormatter | ||
Haalt de datumstijl op voor deze DateTimeFormatter-instantie. | DateTimeFormatter | ||
Retourneert de tekenreeks voor het patroon waarmee de datum en tijd wordt opgemaakt door dit DateTimeFormatter-object. | DateTimeFormatter | ||
Retourneert een geheel getal dat overeenkomt met de eerste dag van de week voor dit landinstelling- en tijdsysteem. | DateTimeFormatter | ||
Haalt een lijst op met de gelokaliseerde tekenreeksen voor de namen van de maanden van het huidige kalendersysteem. | DateTimeFormatter | ||
Haalt de tijdstijl op voor deze DateTimeFormatter-instantie. | DateTimeFormatter | ||
Haalt een lijst op met gelokaliseerde tekenreeksen voor de namen van de weekdagen van het huidige kalendersysteem. | DateTimeFormatter | ||
|
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | |
|
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | |
|
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | |
Haalt de tekenreeks op voor het patroon waarmee de datum en tijd wordt opgemaakt door dit DateTimeFormatter-object. | DateTimeFormatter | ||
Stelt de datum- en tijdstijlen in voor deze DateTimeFormatter-instantie. | DateTimeFormatter | ||
|
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in. | Object | |
|
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies. | Object | |
|
Retourneert een tekenreeksrepresentatie van het opgegeven object. | Object | |
|
Retourneert de primitieve waarde van het opgegeven object. | Object | |
actualLocaleIDName | eigenschap |
actualLocaleIDName:String [alleen-lezen] | Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10.1, AIR 2 |
De naam van de werkelijke landinstellings-id die door dit DateTimeFormatter-object wordt gebruikt.
Er zijn drie mogelijke waarden voor de naam, afhankelijk van het besturingssysteem en de waarde van de requestedLocaleIDName-parameter die wordt doorgegeven aan de Collator()-constructor.
- Als de aangevraagde landinstelling niet gelijk is aan
LocaleID.DEFAULTen het besturingssysteem ondersteuning voor de aangevraagde landinstelling biedt, is de geretourneerde naam gelijk aan de eigenschaprequestedLocaleIDName. - Als
LocaleID.DEFAULTis gebruikt als waarde voor de parameterrequestedLocaleIDNameaan de constructor, wordt de naam van de huidige landinstelling zoals opgegeven door het besturingssysteem van de gebruiker gebruikt. Met de waardeLocaleID.DEFAULTblijft de aangepaste gebruikersinstelling in het besturingssysteem behouden. Als u een expliciete waarde doorgeeft als parameterrequestedLocaleIDName, krijgt u niet noodzakelijkerwijs hetzelfde resultaat als wanneer uLocaleID.DEFAULTgebruikt, ook al zijn beide namen voor de landinstellings-id's gelijk. Misschien heeft de gebruiker de landinstellingen op zijn computer aangepast. Doordat u een expliciete naam van een landinstellings-id aanvraagt (en nietLocaleID.DEFAULTgebruikt), worden deze aangepaste instellingen niet door uw toepassing opgehaald. - Als het systeem geen ondersteuning biedt voor de
requestedLocaleIDNamedie in de constructor is opgegeven, wordt een fallback-landinstellings-id gebruikt.
Implementatie
public function get actualLocaleIDName():StringVerwante API-elementen
lastOperationStatus | eigenschap |
lastOperationStatus:String [alleen-lezen] | Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10.1, AIR 2 |
De status van de voorgaande bewerking die door dit object DateTimeFormatter is uitgevoerd. De eigenschap lastOperationStatus wordt ingesteld wanneer de constructor of een methode van deze klasse wordt aangeroepen of wanneer een andere eigenschap wordt ingesteld. Zie de beschrijving van de verschillende methoden voor de mogelijke waarden.
Implementatie
public function get lastOperationStatus():StringVerwante API-elementen
requestedLocaleIDName | eigenschap |
requestedLocaleIDName:String [alleen-lezen] | Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10.1, AIR 2 |
De naam van de aangevraagde landinstellings-id die is doorgegeven aan de constructor van dit DateTimeFormatter-object.
Als u de waarde LocaleID.DEFAULT hebt gebruikt, is de geretourneerde naam 'i-default'. Als een fallback-landinstelling wordt toegepast, kan de werkelijk gebruikte landinstelling afwijken van de aangevraagde landinstelling. De naam van de werkelijke landinstelling kan worden opgehaald met de eigenschap actualLocaleIDName.
Implementatie
public function get requestedLocaleIDName():StringVerwante API-elementen
DateTimeFormatter | () | Constructor |
public function DateTimeFormatter(requestedLocaleIDName:String, dateStyle:String = "long", timeStyle:String = "long")| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10.1, AIR 2 |
Maakt een nieuw DateTimeFormatter-object waarmee de datum en tijd worden opgemaakt volgens de conventies van de opgegeven landinstelling en opmaakstijl voor de datum en tijd. Met stijlen voor de datum en tijd worden de datum- en tijdnotatiepatronen ingesteld op de vooraf gedefinieerde landinstellingpatronen van het besturingssysteem.
Deze constructor bepaalt of het huidige besturingssysteem ondersteuning biedt voor de aangevraagde naam van de landinstellings-id. Als er geen ondersteuning is, wordt een fallback-landinstelling gebruikt. De naam van de fallback-landinstellings-id kan worden bepaald aan de hand van de eigenschap actualLocaleIDName.
Als een fallback wordt gebruikt voor een van de parameters requestedLocaleIDName, dateStyle of timeStyle, geeft de instelling van de eigenschap lastOperationStatus het type fallback aan.
Als u een opmaak wilt toepassen die is gebaseerd op de huidige voorkeuren van het besturingssysteem, geeft u de waarde LocaleID.DEFAULT in de parameter requestedLocaleIDName door aan de constructor.
Wanneer de constructor wordt aangeroepen en succesvol wordt afgerond, is de eigenschap lastOperationStatus ingesteld op:
LastOperationStatus.NO_ERROR
Wanneer de aangevraagde naam voor de landinstellings-id niet beschikbaar is, wordt lastOperationStatus ingesteld op een van de volgende waarden:
LastOperationStatus.USING_FALLBACK_WARNINGLastOperationStatus.USING_DEFAULT_WARNING
In het andere geval wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die in de LastOperationStatus-klasse worden gedefinieerd.
Meer informatie over de bovenstaande waarschuwingen en andere mogelijke waarden voor de eigenschap lastOperationStatus vindt u in de beschrijvingen in de LastOperationStatus-klasse.
requestedLocaleIDName:String — De voorkeursnaam voor de landinstellings-id bij het bepalen van de datum- en tijdnotatie.
| |
dateStyle:String (default = "long")
| |
timeStyle:String (default = "long")
|
Gegenereerde uitzondering
ArgumentError — als de parameter dateStyle of timeStyle geen geldige DateTimeStyle-constante is.
| |
TypeError — als de parameter dateStyle of timeStyle de waarde null heeft.
|
Verwante API-elementen
format | () | methode |
public function format(dateTime:Date):String| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10.1, AIR 2 |
Bepaalt de opmaak van een weergavetekenreeks voor een Date-object waarvan wordt aangenomen dat het in de lokale tijd van de gebruiker staat, dat wil zeggen: met de lokale tijdcomponenten van het Date-object (date, day, fullYear, hours, minutes, month en seconds). De opmaak wordt gebaseerd op de conventies van de landinstellings-id en op de opmaakstijl voor de datum en tijd. De opmaak kan ook worden gebaseerd op het aangepaste datum- en tijdpatroon dat voor deze instantie DateTimeFormatter is opgegeven.
Wanneer deze methode wordt aangeroepen en met succes wordt voltooid, wordt de eigenschap lastOperationStatus ingesteld op:
LastOperationStatus.NO_ERROR
Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.
Parameters
dateTime:Date — Een Date-waarde die moet worden opgemaakt. Het geldige bereik loopt van 1 januari 1601 tot en met 31 december 30827.
|
String — Een opgemaakte tekenreeks die staat voor de datum- of tijdwaarde.
|
Verwante API-elementen
formatUTC | () | methode |
public function formatUTC(dateTime:Date):String| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10.1, AIR 2 |
Bepaalt de opmaak van een weergavetekenreeks voor een Date-object waarvan wordt aangenomen dat het in UTC-tijd staat, dat wil zeggen: met de UTC-tijdcomponenten van het Date-object (dateUTC, dayUTC, fullYearUTC, hoursUTC, minutesUTC, monthUTC en secondsUTC), volgens het dateStyle-, timeStyle- of datumtijdpatroon. De opmaak wordt gebaseerd op de conventies van de landinstellings-id en op de opmaakstijl voor de datum en tijd. De opmaak kan ook worden gebaseerd op het aangepaste datum- en tijdpatroon dat voor deze instantie DateTimeFormatter is opgegeven.
Wanneer deze methode wordt aangeroepen en met succes wordt voltooid, wordt de eigenschap lastOperationStatus ingesteld op:
LastOperationStatus.NO_ERROR
Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.
Parameters
dateTime:Date — Een Date-waarde die moet worden opgemaakt. Het geldige bereik loopt van 1 januari 1601 tot en met 31 december 30827.
|
String — Een opgemaakte tekenreeks die staat voor de datum- of tijdwaarde.
|
Verwante API-elementen
getAvailableLocaleIDNames | () | methode |
public static function getAvailableLocaleIDNames():Vector.<String>| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10.1, AIR 2 |
Biedt een overzicht van alle namen van landinstellings-id's die door deze klasse worden ondersteund.
Als deze klasse niet word ondersteund op het huidige besturingssysteem, retourneert deze methode de waarde null.
Wanneer deze methode wordt aangeroepen en met succes wordt voltooid, wordt de eigenschap lastOperationStatus ingesteld op:
LastOperationStatus.NO_ERROR
Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.
Vector.<String> — Een tekenreeksvector met alle namen van landinstellings-id's die door deze klasse worden ondersteund.
|
Verwante API-elementen
getDateStyle | () | methode |
public function getDateStyle():String| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10.1, AIR 2 |
Haalt de datumstijl op voor deze DateTimeFormatter-instantie. De datumstijl wordt gebruikt om een vooraf gedefinieerd datumnotatiepatroon op te halen uit het besturingssysteem. De datumstijlwaarde kan worden ingesteld door de constructor DateTimeFormatter(), de methode setDateTimeStyles() of de methode setDateTimePattern().
Wanneer deze methode wordt aangeroepen en met succes wordt voltooid, wordt de eigenschap lastOperationStatus ingesteld op:
LastOperationStatus.NO_ERROR
Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.
String — De datumstijltekenreeks voor deze formatter.
Mogelijke waarden:
|
Verwante API-elementen
getDateTimePattern | () | methode |
public function getDateTimePattern():String| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10.1, AIR 2 |
Retourneert de tekenreeks voor het patroon waarmee de datum en tijd wordt opgemaakt door dit DateTimeFormatter-object.
Dit patroon kan op een van de volgende drie manieren worden ingesteld:
- Door de parameters
dateStyleentimeStyledie in de constructor worden gebruikt - Door de
setDateTimeStyles()-methode - Door de methode
setDateTimePattern().
Raadpleeg de methode setDateTimePattern() voor een omschrijving van de patroonsyntaxis.
Wanneer deze methode wordt aangeroepen en met succes wordt voltooid, wordt de eigenschap lastOperationStatus ingesteld op:
LastOperationStatus.NO_ERROR
Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.
String — Een tekenreeks met het patroon dat door dit DateTimeFormatter-object wordt gebruikt om datums en tijden mee op te maken.
|
Verwante API-elementen
getFirstWeekday | () | methode |
public function getFirstWeekday():int| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10.1, AIR 2 |
Retourneert een geheel getal dat overeenkomt met de eerste dag van de week voor dit landinstelling- en tijdsysteem. De waarde 0 komt overeen met zondag, 1 komt overeen met maandag enzovoort, en 6 komt overeen met zaterdag.
Wanneer deze methode wordt aangeroepen en met succes wordt voltooid, wordt de eigenschap lastOperationStatus ingesteld op:
LastOperationStatus.NO_ERROR
Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.
int — Een geheel getal dat overeenkomt met de eerste dag van de week voor deze landinstelling en dit kalendersysteem.
|
Verwante API-elementen
getMonthNames | () | methode |
public function getMonthNames(nameStyle:String = "full", context:String = "standalone"):Vector.<String>| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10.1, AIR 2 |
Haalt een lijst op met de gelokaliseerde tekenreeksen voor de namen van de maanden van het huidige kalendersysteem. Het eerste element in de lijst is de naam voor de eerste maand van het jaar.
Wanneer deze methode wordt aangeroepen en met succes wordt voltooid, wordt de eigenschap lastOperationStatus ingesteld op:
LastOperationStatus.NO_ERROR
Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.
Parameters
nameStyle:String (default = "full")
| |
context:String (default = "standalone")
|
Vector.<String> — Een vector met gelokaliseerde tekenreeksen met de namen van de maanden voor de opgegeven landinstelling, naamstijl en context. Het eerste element in de vector (op index 0) is de naam voor de eerste maand van het jaar. Het volgende element is de naam voor de tweede maand van het jaar, enzovoort.
|
Gegenereerde uitzondering
TypeError — als de parameter nameStyle of context de waarde null heeft.
|
Verwante API-elementen
getTimeStyle | () | methode |
public function getTimeStyle():String| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10.1, AIR 2 |
Haalt de tijdstijl op voor deze DateTimeFormatter-instantie. De tijdstijl wordt gebruikt om een vooraf gedefinieerd tijdnotatiepatroon op te halen uit het besturingssysteem. De tijdstijlwaarde kan worden ingesteld door de constructor DateTimeFormatter(), de methode setDateTimeStyles() of de methode setDateTimePattern().
Wanneer deze methode wordt aangeroepen en met succes wordt voltooid, wordt de eigenschap lastOperationStatus ingesteld op:
LastOperationStatus.NO_ERROR
Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.
String — De tijdstijltekenreeks voor deze formatter.
Mogelijke waarden:
|
Verwante API-elementen
getWeekdayNames | () | methode |
public function getWeekdayNames(nameStyle:String = "full", context:String = "standalone"):Vector.<String>| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10.1, AIR 2 |
Haalt een lijst op met gelokaliseerde tekenreeksen voor de namen van de weekdagen van het huidige kalendersysteem. Het eerste element in de lijst is de naam voor zondag.
Wanneer deze methode wordt aangeroepen en met succes wordt voltooid, wordt de eigenschap lastOperationStatus ingesteld op:
LastOperationStatus.NO_ERROR
Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.
Parameters
nameStyle:String (default = "full")
| |
context:String (default = "standalone")
|
Vector.<String> — Een vector met gelokaliseerde tekenreeksen met de namen van de maanden voor de opgegeven landinstelling, naamstijl en context. Het eerste element in de vector (op index 0) is de naam voor zondag. Het volgende element is de naam voor maandag, enzovoort.
|
Gegenereerde uitzondering
TypeError — als de parameter nameStyle of context de waarde null heeft.
|
Verwante API-elementen
setDateTimePattern | () | methode |
public function setDateTimePattern(pattern:String):void| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10.1, AIR 2 |
Haalt de tekenreeks op voor het patroon waarmee de datum en tijd wordt opgemaakt door dit DateTimeFormatter-object.
Het patroon voor de datumnotatie kan op een van de volgende drie manieren worden ingesteld:
- Door de parameters
dateStyleentimeStyledie in de constructor worden gebruikt - Door de
setDateTimeStyles()-methode - Door deze
setDateTimePattern()-methode.
Deze methode heeft als neveneffect dat de huidige datum- en tijdstijlen voor dit object DateTimeFormatter worden genegeerd en worden ingesteld op de waarde DateTimeStyle.CUSTOM.
Een patroontekenreeks definieert de opmaak van de datum- en tijdnotatie. Het patroon bevat letterreeksen die worden vervangen met datum- en tijdwaarden in de opgemaakte tekenreeks. In het patroon 'yyyy/MM' worden de letters 'yyyy' bijvoorbeeld vervangen door een viercijferig jaar. Dan volgt het teken '/'. De letters 'MM' worden vervangen door een tweecijferige maand.
Veel van de in patronen gebruikte letters kunnen meer dan eens worden herhaald, zodat er verschillende typen uitvoer worden gegenereerd. Raadpleeg de onderstaande tabel voor een omschrijving.
Als een reeks het maximumaantal letters overschrijdt dat door een patroon wordt ondersteund, wordt de reeks gekoppeld aan de langste ondersteunde reeks voor de desbetreffende patroonletter. Bijvoorbeeld:
- MMMMMM wordt vervangen door MMMM
- dddd wordt vervangen door dd
- EEEEEEE wordt vervangen door EEEE
- aa wordt vervangen door a
- hhh wordt vervangen door hh
- mmmm wordt vervangen door mm
In theorie kan een patroon maximaal 255 tekens bevatten, maar bij sommige platformen ligt deze limiet lager. Als de tekenlimiet van een patroon wordt overschreden, wordt de eigenschap lastOperationStatus ingesteld op de waarde LastOperationStatus.PATTERN_SYNTAX_ERROR.
Niet alle besturingssystemen bieden ondersteuning voor alle mogelijke patronen. Als een besturingssysteem geen ondersteuning voor een patroon biedt, wordt er een fallback-patroon gebruikt. De instelling van de eigenschap lastOperationStatus geeft dan aan dat er een fallback-patroon wordt gebruikt. Als er geen redelijk fallback-patroon kan worden geleverd, wordt een lege tekenreeks gebruikt. De instelling van de eigenschap lastOperationStatus geeft dan aan dat het patroon niet wordt ondersteund.
In de volgende tabel vindt u een omschrijving van de geldige patroonletters en hun betekenis.
| Patroonletter | Beschrijving |
| G | Tijdperk. Wordt vervangen door de tijdperktekenreeks voor de huidige datum en kalender. Dit patroon wordt niet ondersteund door alle besturingssystemen. Op besturingssystemen die geen ondersteuning bieden voor het tijdperk worden de letters van het invoerpatroon vervangen door een lege tekenreeks.
Een tijdperkpatroon kan een tot vijf letters bevatten. Deze worden als volgt geïnterpreteerd:
Voorbeelden voor de Gregoriaanse kalender (voor besturingssystemen die ondersteuning bieden voor dit patroon):
|
| y | Jaar. Als het patroon twee letters bevat, worden de laatste twee cijfers van het jaar weergegeven. In andere gevallen wordt het aantal cijfers bepaald door het aantal letters. Als voor de jaarwaarde meer cijfers nodig zijn dan worden geleverd door het aantal letters, wordt de volledige jaarwaarde weergegeven. Als er meer letters dan nodig voor de waarde zijn, worden er voorloopnullen aan de jaarwaarden toegevoegd. In de volgende lijst staan de resultaten voor de jaren 1 en 2005.
Voorbeelden:
|
| M | Maand in jaar. Een maandpatroon kan een tot vijf letters bevatten. Deze worden als volgt geïnterpreteerd:
Voorbeelden:
|
| d | Dag van de maand. Patronen voor dagen van de maand kunnen een of twee letters bevatten. Deze worden als volgt geïnterpreteerd:
Voorbeelden:
|
| E | Dag van de week. Patronen voor dagen van de week kunnen een of vijf letters bevatten. Deze worden als volgt geïnterpreteerd:
Voorbeelden:
|
| Q | Kwartaal. Sommige platforms bieden geen ondersteuning voor dit patroon. Een kwartaalpatroon kan een tot vier letters bevatten. Deze worden als volgt geïnterpreteerd:
Voorbeelden (voor besturingssystemen die ondersteuning bieden voor dit patroon):
|
| w | Week van het jaar. Sommige platforms bieden geen ondersteuning voor dit patroon. Dit patroon kan een of twee letters bevatten. Deze worden als volgt geïnterpreteerd:
Voorbeelden voor de tweede week van het jaar (voor besturingssystemen die ondersteuning bieden voor dit patroon):
|
| W | Week van de maand. Sommige platforms bieden geen ondersteuning voor dit patroon. Bij dit patroon is slechts één letter toegestaan.
Voorbeelden voor de tweede week van juli (voor besturingssystemen die ondersteuning bieden voor dit patroon):
|
| D | Dag van het jaar. Sommige platforms bieden geen ondersteuning voor dit patroon. Dit patroon kan een tot drie letters bevatten.
Voorbeelden voor de tweede dag van het jaar (voor besturingssystemen die ondersteuning bieden voor dit patroon):
|
| F | Instantie van een dag van de week binnen een kalendermaand. Dit element geeft bijvoorbeeld '3' weer, als dit wordt gebruikt voor de opmaak van de datum van de derde maandag van oktober. Bij dit patroon is slechts één letter toegestaan.
Voorbeelden voor de tweede woensdag van juli (voor besturingssystemen die ondersteuning bieden voor dit patroon):
|
| a | Indicator voor a.m./p.m. Dit patroon kan slechts één letter bevatten, een a of een p.
Voorbeelden:
|
| h | Uur van de dag in een 12-uursnotatie [1 - 12]. Dit patroon moet uit een of twee letters bestaan.
Voorbeelden:
|
| H | Uur van de dag in een 24-uursnotatie [0 - 23]. Dit patroon moet uit een of twee letters bestaan.
Voorbeelden:
|
| K | Uur van de dag in een 12-uursnotatie [0 - 11]. Dit patroon moet uit een of twee letters bestaan. Dit patroon wordt niet ondersteund door alle besturingssystemen.
Voorbeelden (voor besturingssystemen die ondersteuning bieden voor dit patroon):
|
| k | Uur van de dag in een 24-uursnotatie [1 - 24]. Dit patroon moet uit een of twee letters bestaan. Dit patroon wordt niet ondersteund door alle besturingssystemen.
Voorbeelden (voor besturingssystemen die ondersteuning bieden voor dit patroon):
|
| m | Minuut van het uur [0 - 59]. Dit patroon moet uit een of twee letters bestaan.
Voorbeelden:
|
| s | Seconden in de minuut [0 - 59]. Dit patroon moet uit een of twee letters bestaan.
Voorbeelden:
|
| S | Milliseconden. Dit patroon moet uit een tot vijf letters bestaan. De waarde wordt afgerond op basis van het aantal gebruikte letters. Wanneer er vijf tekens worden gebruikt (SSSSS), geeft dit fractionele milliseconden weer.
Voorbeelden:
|
| z | Tijdzone. Geeft de tijdzone weer als een tekenreeks die rekening houdt met zomer- of wintertijd, zonder dat er een specifieke locatie wordt aangegeven. Dit patroon wordt niet ondersteund door alle besturingssystemen. Bij besturingssystemen die geen ondersteuning bieden voor tijdzonepatronen worden de letters van het invoerpatroon vervangen door een lege tekenreeks. Op besturingssystemen die ondersteuning bieden voor dit patroon is er niet voor alle landinstellingen een gedefinieerde tekenreeks beschikbaar. Bij deze landinstellingen wordt een gelokaliseerde GMT-notatie gebruikt, zoals GMT-08:00 of GW-08:00.
Dit tijdzonepatroon moet een tot vier letters bevatten, die als volgt worden geïnterpreteerd:
Voorbeelden voor besturingssystemen die ondersteuning bieden voor deze opmaak:
|
| Z | Tijdzone. Geeft de tijdzone weer op basis van het tijdsverschil met GMT. Dit patroon wordt niet ondersteund door alle besturingssystemen. Bij besturingssystemen die geen ondersteuning bieden voor tijdzonepatronen worden de letters van het invoerpatroon vervangen door een lege tekenreeks.
Dit tijdzonepatroon moet een tot vier letters bevatten, die als volgt worden geïnterpreteerd:
Voorbeelden voor besturingssystemen die ondersteuning bieden voor deze opmaak:
|
| ww | Tijdzone. Een tekenreeks die de algemene tijdzone weergeeft, zonder dat er een specifieke locatie wordt aangegeven of onderscheid wordt gemaakt tussen zomer- en wintertijd. Dit patroon wordt niet ondersteund door alle besturingssystemen. Op besturingssystemen die geen ondersteuning bieden voor tijdzonepatronen worden de letters van het invoerpatroon vervangen door een lege tekenreeks. Op besturingssystemen die ondersteuning bieden voor dit patroon worden fallback-tekenreeksen weergegeven als een gelokaliseerde naam niet beschikbaar is.
Dit tijdzonepatroon kan een of vier letters bevatten. Deze worden als volgt geïnterpreteerd:
Voorbeelden voor besturingssystemen die ondersteuning bieden voor deze opmaak:
|
| 'Overige tekst' | De patroontekenreeks mag tekst en punctuatie bevatten. De tekens van a tot z en van A tot Z zijn echter gereserveerd als syntaxistekens. Als u deze tekens in de opgemaakte tekenreeks wilt opnemen, moet u ze tussen enkele aanhalingstekens zetten. Als u een enkel aanhalingsteken in de resultaattekenreeks wilt laten weergeven, moet u in de patroontekenreeks twee enkele aanhalingstekens gebruiken. De twee enkele aanhalingstekens mogen binnen of buiten een gedeelte tussen aanhalingstekens van de patroontekenreeks vallen. Een niet-overeenkomend paar enkele aanhalingstekens wordt aan het eind van de tekenreeks afgebroken.
Voorbeelden:
|
Wanneer deze methode wordt aangeroepen en met succes wordt voltooid, wordt de eigenschap lastOperationStatus ingesteld op:
LastOperationStatus.NO_ERROR
Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.
Parameters
pattern:String |
Gegenereerde uitzondering
TypeError — als de patroonparameter null is.
|
Verwante API-elementen
setDateTimeStyles | () | methode |
public function setDateTimeStyles(dateStyle:String, timeStyle:String):void| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10.1, AIR 2 |
Stelt de datum- en tijdstijlen in voor deze DateTimeFormatter-instantie. Met stijlen voor de datum en tijd worden de datum- en tijdnotatiepatronen ingesteld op de vooraf gedefinieerde landinstellingpatronen van het besturingssysteem. Met deze methode worden de stijlen vervangen die zijn ingesteld met de constructor DateTimeFormatter() of met de methode setDateTimePattern(). Het datum- en tijdpatroon wordt eveneens bijgewerkt op basis van de ingestelde stijlen.
Wanneer deze methode wordt aangeroepen en met succes wordt voltooid, wordt de eigenschap lastOperationStatus ingesteld op:
LastOperationStatus.NO_ERROR
Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.
Parameters
dateStyle:String — Geeft aan welke stijl wordt gebruikt bij de datumnotatie. De waarde komt overeen met een van de opgesomde waarden in de klasse DateTimeStyle:
| |
timeStyle:String — Geeft aan welke stijl wordt gebruikt voor de tijdnotatie. De waarde komt overeen met een van de opgesomde waarden in de klasse DateTimeStyle:
|
Gegenereerde uitzondering
ArgumentError — als de parameter dateStyle of timeStyle geen geldige DateTimeStyle-constante is.
| |
TypeError — als de parameter dateStyle of timeStyle de waarde null heeft.
|
Verwante API-elementen
In dit voorbeeld worden de volgende landinstellingen gebruikt: Engels (Verenigde Staten), Frans (Frankrijk) en Spaans (Spanje).
In het voorbeeld wordt voor elke landinstelling in de lijst het volgende uitgevoerd:
- Er wordt een DateTimeFormatter-object gemaakt in de standaardstijl (lange dateStyle, lange timeStyle).
- Hiermee wordt de huidige datum en tijd opgemaakt met de standaard lange datumstijl.
- Schakel over naar een korte datumstijl met alleen de tijd, met behulp van de constanten
DateTimeStyle.NONEenDateTimeStyle.SHORT. - Hiermee wordt de huidige datum en tijd opgemaakt met de korte datumstijl met alleen de tijd.
package {
import flash.display.Sprite;
import flash.globalization.DateTimeFormatter;
import flash.globalization.DateTimeStyle;
public class DateTimeFormatterExample extends Sprite
{
private var localeList:Array = new Array("en-US", "fr-FR", "es-ES");
public function DateTimeFormatterExample()
{
var date:Date = new Date();
for each (var locale:String in localeList) {
var dtf:DateTimeFormatter = new DateTimeFormatter(locale);
trace('\n' + "LocaleID requested=" + dtf.requestedLocaleIDName
+ "; actual=" + dtf.actualLocaleIDName);
var longDate:String = dtf.format(date);
trace(longDate + " (" + dtf.getDateTimePattern() + ")");
dtf.setDateTimeStyles(DateTimeStyle.NONE, DateTimeStyle.SHORT);
var shortDate:String = dtf.format(date);
trace(shortDate + " (" + dtf.getDateTimePattern() + ")");
}
}
}
}
In het voorbeeld wordt voor elke landinstelling in de lijst het volgende uitgevoerd:
- Hiermee worden drie invoer- en uitvoer-tekstvelden gemaakt.
- Hiermee wordt een DateTimeFormatter-object gemaakt met behulp van de Amerikaans-Engelse landinstelling.
- Roept de
configureTextField()-functie op. Door deze functie worden de positie en grootte van tekstvelden ingesteld en wordt een gebeurtenislistener aan het objectpatternFieldtoegevoegd. - Wanneer de gebruiker een patroon in het
patternField-tekstveld invoert, maakt detextInputHandler-functie de huidige datum en tijd op met het patroon en wordt het resultaat en delastOperationStatus-waarde in de uitvoertekstvelden weergegeven.
package {
import flash.display.Sprite;
import flash.events.Event;
import flash.globalization.DateTimeFormatter;
import flash.text.*;
public class DateTimePatternExample extends Sprite
{
private var patternField:TextField = new TextField();
private var resultField:TextField = new TextField();
private var statusField:TextField = new TextField();
private var date:Date = new Date();
private var dtf:DateTimeFormatter = new DateTimeFormatter("en-US");
private function configureTextField():void
{
patternField.type = TextFieldType.INPUT;
patternField.width = 300;
patternField.height = 20;
patternField.background = true;
patternField.border = true;
resultField.y = 40;
resultField.width = 300;
resultField.height = 20;
statusField.y = 80;
statusField.width = 300;
statusField.height = 20;
addChild(patternField);
addChild(resultField);
addChild(statusField);
patternField.addEventListener(Event.CHANGE,textInputHandler);
}
private function textInputHandler(event:Event):void
{
dtf.setDateTimePattern(patternField.text);
statusField.text = dtf.lastOperationStatus;
resultField.text = dtf.format(date);
}
public function DateTimePatternExample()
{
configureTextField();
}
}
}
Wed Jun 13 2018, 11:42 AM Z